home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / Clicker / README < prev    next >
Text File  |  1996-09-26  |  5KB  |  130 lines
  1. Clicker 1.0:  A key-click commodity
  2.  
  3. REQUIREMENTS
  4.  
  5.   An Amiga running at least release 2.0 of the OS (KickStart V36 or better),
  6.   a keyboard, and a loudspeaker to hear the sounds through.
  7.  
  8.  
  9. COPYRIGHT
  10.  
  11.   This program is in the Public Domain.  That means you can legally create and
  12.   publish an improved version and claim full copyright over it;  in fact I would
  13.   probably help you do so in any way I can.  Even claiming copyright over my
  14.   unmodified work would technically be legal, but you would make yourself look
  15.   like a complete arse if you did.  In fact I would probably help you do so in
  16.   any way I can.
  17.  
  18.   I'm serious.  Take a look at the sources, they're quite clean and readable if
  19.   you are familiar with C.  It's pure ANSI C and not (too) dependent on any
  20.   particular compiler.
  21.  
  22.  
  23. INTRODUCTION
  24.  
  25.   This program makes a clicking noise each time you press a key.
  26.  
  27.   Call me crazy (I mean really, go ahead, everybody's doing it) but I hate to
  28.   use keyboards that don't click.  Why?  Well first of all I find no
  29.   encouragement in a machine which just doesn't seem to care.  The Amiga is a
  30.   caring and personal system and it should give you some kind of happy feedback
  31.   --just to show you that it's listening.
  32.  
  33.   Second I like to type without having to look intently at the screen all the
  34.   time.  Whether it's because somebody is talking to me and I have to pretend
  35.   to listen patiently while I'm really still programming, or just because the
  36.   A4000 keyboard doesn't have a reassuring clonk to it so you have to press the
  37.   keys all the way down to make sure that it got the message.  Clicker lets me
  38.   type lighter and faster because one gets to know exactly how much pressure
  39.   the keys require.
  40.  
  41.   Oh and third of course, it annoys the hell out of everybody in a five-meter
  42.   radius so they have something to talk about and can stop worrying about their
  43.   own problems for a minute  (it's an odd thing really that so few people at
  44.   university appreciate what I'm doing for them).  Try it!
  45.  
  46.  
  47. INSTALLATION
  48.  
  49.   This is the simple part.  Just drag the program icon anywhere you like.  If
  50.   you want Clicker to be started automatically when you boot your computer, drag
  51.   it into the WBStartup drawer on your system disk.
  52.  
  53.  
  54. USAGE
  55.  
  56.   Double-clicking the Clicker icon or typing its name from the shell will start
  57.   the program.  Once Clicker is running, double-clicking the icon or typing the
  58.   name again will bring up the program's preferences window.  This is still very
  59.   primitive (no loading or saving yet), but at least it lets you alter volume,
  60.   pitch and duration of the clicks.
  61.  
  62.   The window can also be brought up by selecting Clicker's entry from the
  63.   program list in the Commodities Exchange window and clicking on the Show
  64.   Interface button.  You can also disactivate and reactivate Clicker from there,
  65.   or quit the program altogether.
  66.  
  67.   Here's an overview of the controls in the preferences window:
  68.  
  69.    * Click Mouse Button: If you want Clicker to make its key-click noise for
  70.      mouse-button presses as well as when keys are pressed, select the "Click
  71.      Mouse button" gadget.
  72.  
  73.    * Pitch:  You can pick any tone from the musical scale for the key-click
  74.      noise.  The frequency in Hertz is shown next to the Pitch slider;
  75.      Drag the slider to the  left to get a lower tone, or to the right to get a
  76.      higher one.  Unfortunately there's only a very short range of useful
  77.      pitches at the moment.
  78.  
  79.   (For the musically literate user:  In a vain and deluded attempt to not offend
  80.   anybody's ears the tone of the clicks can be selected over a 9-octave range of
  81.   the equal-temperament tuning based on the 440-Hertz A)
  82.  
  83.    * Length:  This determines how long the noise of every click should last.
  84.   Because the duration of a key click is typically very short, the Length
  85.   setting does not regulate the number of microseconds the sound is played, but
  86.   the number of times the entire wave-form sample is played altogether.  This
  87.   means that with the same Length setting you will get longer duration for low
  88.   pitches than with higher pitches.
  89.  
  90.  
  91. OPTIONS
  92.  
  93.   Shell command-line template:  PITCH/N VOLUME/N LENGTH/N CLICKMOUSE/S
  94.  
  95.   Icon tooltypes:
  96.         PITCH=<frequency in Hertz>
  97.         VOLUME=<loudness between 1 and 64>
  98.         LENGTH=<length of click>
  99.         CLICKMOUSE=<YES or NO>
  100.  
  101.   See USAGE for an explanation of these settings.
  102.  
  103.  
  104. AUTHOR
  105.  
  106.   Jeroen Vermeulen, currently still a Computer Science student at the university
  107.   of Leiden, The Netherlands but soon to be unleashed upon an unprepared outside
  108.   world.  It will be hard for life to adjust itself to me again, but I'll be
  109.   damned if I'm going to work with Windows.  Got a position open by any chance?
  110.  
  111.   Mail: jvermeul@wi.leidenuniv.nl / jtv@xs4all.nl
  112.   Phone/Fax: +31.20.6258990
  113.  
  114.  
  115. THANK YOU
  116.  
  117.   Martijn van Hasselt - for using this program and not calling me mad, even
  118.         behind my back (yes Martijn, I *have* been tapping your phone).
  119.  
  120.   Manfred Schmitt - for walking into a shop and saying "I want to buy Commodore
  121.         Computers"... and not responding to the question "how many?"
  122.  
  123.  
  124. REVISION HISTORY
  125.  
  126.   (lots of 0.x versions that you don't want to know about unless you're one of
  127.   my beta testers, but they inexplicably insisted on remaining anonymous)
  128.  
  129.   1.0 - First public release
  130.